'DeclarationPublic Overloads Function OMRDetectOvalMarks( _ ByVal ImageID As Integer, _ ByRef Areas() As Integer, _ ByVal AreasCount As Integer, _ ByVal Sensitivity As Double, _ ByRef Confidence() As Integer, _ ByVal HasCharacter As Boolean _ ) As Integer()
public int[] OMRDetectOvalMarks( int ImageID, ref int[] Areas, int AreasCount, double Sensitivity, ref int[] Confidence, bool HasCharacter )
public function OMRDetectOvalMarks( ImageID: Integer; var Areas: Integerarray of; AreasCount: Integer; Sensitivity: Double; var Confidence: Integerarray of; HasCharacter: Boolean ): array of Integer;
public function OMRDetectOvalMarks( ImageID : int, Areas : int[], AreasCount : int, Sensitivity : double, Confidence : int[], HasCharacter : boolean ) : int[];
public: int[]* OMRDetectOvalMarks( int ImageID, ref int[]* Areas, int AreasCount, double Sensitivity, ref int[]* Confidence, bool HasCharacter )
public: array<int>^ OMRDetectOvalMarks( int ImageID, array<int>^% Areas, int AreasCount, double Sensitivity, array<int>^% Confidence, bool HasCharacter )
Parameters
- ImageID
- GdPicture image identifier.
- Areas
- Array of Integer. This parameter is used as a reference to the location of the OMR Fields. Where each quadruplet (left, top, width, height) corresponds to a rectangle surrounding a single OMR field. For example, if 40 entries exist in Areas, there will be 10 OMR Fields to be investigated whether they were checked (filled) or not.
- AreasCount
- Number of Rectangles sent to the method. Basically, the length of Areas().
- Sensitivity
- How sensitive the method is to degree of filling of the OMR field in respect to the size of the field itself. Higher values will result in more tolerant results where semi filling of the field would yield positive results. Lower values will result in less tolerant results where maximum filling of the field only would yield positive results Sensitivity greatly affects the confidence value returned. Range from 0.0 to 1.0. If different values are entered, they will automatically be limited to this range. Default Value is 0.5.
- Confidence
- Reference to a 1-Dimensional array of Integers. Must be initialized and sent to method. After the method is called, the array elements would correspond to the confidence of the result returned by the method. For Examples, if Confidence[0] = 40, then the first OMR field result returned is 40% accurate. It is important to mark that Confidence is greatly affected by "Sensitivity". Confidence value is a mixture of how much the sensitivity standard was accomplished, how much was it exceeded or unmet. It also details the respect of the filling to the size of the border and the regularity of the border.
- HasCharacter
- Whether the OMR field contains a character inside it or not.
Return Value
The method returns an Array of integers.
If the value of an element is 0, then the field was not filled. If the value of an element is 1, then
the field was filled.
The Elements of the returned array will correspond to the Elements of the Rectangles Array Areas().
Where if the first element of the returned array[0] is 0, then the OMR field surrounded by the
rectangle in the element of Areas[0] was not filled. Similarly, if the first element of the returned
array[5] is 1, then the OMR field surrounded by the rectangle in the element of Areas[5] was filled.